RectInIconMethod

RectInIconMethod
Header:	Icons.h		Carbon status:	Supported

Hit-tests a rectangle against an icon obtained by your icon getter callback function for a specified destination rectangle and alignment.

Boolean RectInIconMethod (
    const Rect *testRect, 
    const Rect *iconRect, 
    IconAlignmentType align, 
    IconGetterUPP theMethod, 
    void *yourDataPtr
);

testRect

A pointer to the rectangle to be tested, specified in local coordinates of the current graphics port.

iconRect

A pointer to the rectangle in which the icon appears, specified in local coordinates of the current graphics port. The rectangle which you specify here should be the same rectangle that you last used to draw the icon.

align

Specifies how the icon against which to hit-test is aligned within the rectangle specified by iconRect. The alignment which you specify here should be the same alignment that you last used to draw the icon. See “Alignment Type Values” for a description of the values you can use in this parameter.

theMethod

A universal procedure pointer to your icon getter callback function. RectInIconMethod passes to your icon getter function the type of the icon your function should retrieve and the value specified in the yourDataPtr parameter. The RectInIconMethod function examines the size of the rectangle and requests the appropriate icon from your icon getter function—an icon of icon type 'ICN#' or 'ics#'. Your icon getter function should return a handle to the data of the requested icon type. The RectInIconMethod function extracts the mask from the icon data that your icon getter function returns. If your icon getter function returns data that does not correspond to an icon of type 'ICN#' or type 'ics#', RectInIconMethod attempts to generate a mask from the returned data.

Your icon getter function can get the data for the icon and its mask using whatever method is appropriate to your application. For example, your application might maintain its own cache of icons (and pass a pointer to it in the yourDataPtr parameter) or use its icon getter function to get an icon from the desktop database.

See the IconGetterProcPtr callback for more information on creating an icon getter function.

yourDataPtr

A pointer to data that is passed to your icon getter function.

function result: TRUE if the rectangle intersects the icon and FALSE if it doesn’t.

SPECIAL CONSIDERATIONS

This function may move or purge memory blocks in the application heap. For that reason, your application should not call it at interrupt time.

AVAILABILITY

Supported in Carbon. Available in CarbonLib 1.0 and later when InterfaceLib 7.1 or later is installed. Exported by CarbonLib 1.0 and later and by InterfaceLib 7.1 and later.